home *** CD-ROM | disk | FTP | other *** search
/ CookBook Heaven / COOKBOOK HEAVEN.iso / mm / importf.doc < prev    next >
Text File  |  1993-03-19  |  6KB  |  125 lines
  1.  
  2.  
  3.  
  4.  
  5.                   MEAL-MASTER IMPORT FILE SPECIFICATIONS
  6.  
  7.  
  8.      The Meal-Master import function was only designed to import
  9.      recipes previously exported from the program.  However, the
  10.      export format is a simple text file that can be created by most
  11.      text editor programs.  Many people have found that recipes from
  12.      other sources can be edited to look like a MM export file,
  13.      allowing them to be imported to MM with little or no retyping.
  14.      All it takes is some patience, some practice, and an
  15.      understanding of exactly what the import process is expecting.
  16.      This file won't help with the first two, but here is a
  17.      description of what the program expects to see in an importable
  18.      file:
  19.  
  20.      FIXED FORMAT (LINES 1 THROUGH 6)
  21.  
  22.        Line 1  The first line of a valid recipe is a "recipe header"
  23.                line.  This line must begin with at least 5 hyphens
  24.                ('-----'), and must contain the words "Meal-Master"
  25.                somewhere on the line.  Any lines found prior to this
  26.                "recipe header" line will be ignored by Meal-Master.
  27.                
  28.                (Note: If this line is missing, Meal-Master will
  29.                attempt to locate the "Title: " line described below,
  30.                and continue with the import process.  However, it is
  31.                recommended that header lines be used when possible)
  32.  
  33.        Line 2  The word "Title:" must begin the line in any position
  34.                before column 7, and be followed by one blank space.
  35.                The recipe title must start after the blank space, and
  36.                may be a maximum of 60 characters in length.
  37.  
  38.        Line 3  The word "Categories:" must begin the line, in any
  39.                position, and be followed by one blank space.  A
  40.                maximum of 5 category names may be entered, beginning
  41.                after the blank space.  A comma should immediately
  42.                follow each category name except the last one; for
  43.                example "Cakes, Desserts".  Category names should start
  44.                with a capital letter, with the remaining characters in
  45.                lower case letters.
  46.  
  47.        Line 4  A numeric quantity between 1 and 9999 (number of
  48.                servings) must appear somewhere on this line.
  49.  
  50.  
  51.      VARIABLE FORMAT - LINES 5 AND GREATER
  52.  
  53.        Beginning with line 5, Meal-Master will attempt to identify
  54.        each line as being an ingredient line, direction line, or the
  55.        "end of recipe" trailer line.
  56.  
  57.        If a line is found that starts with 5 hyphens, and contains no
  58.        characters other than hyphens and spaces, the program considers
  59.  
  60.  
  61.  
  62.        this the "end of recipe" trailer line.  It will store the
  63.        current recipe and begin searching for another "recipe header"
  64.        as described in "Line 1" above.
  65.  
  66.        If all the following are true, the line will be interpreted as
  67.        an ingredient and loaded into Meal-Master:
  68.  
  69.           1) Positions 1-7 contain a valid numeric quantity, either
  70.              expressed as a whole number, decimal fraction, or common
  71.              fraction, or are blank.
  72.  
  73.           2) Positions 9-10 contain one of the valid Meal-Master unit
  74.              of measure codes, including blanks. (see list in
  75.              program).
  76.  
  77.           3) Positions 12-39 contain text for an ingredient name, or a
  78.              "-" in position 12 and text in positions 13-39 (the
  79.              latter is a "continuation" line for the previous
  80.              ingredient name).
  81.  
  82.        If all the following are true, the line will be interpreted as
  83.        an ingredient heading line:
  84.  
  85.           1) Positions 1-5 contain hyphens ("-----").
  86.  
  87.           2) The line is at least 40 characters long.
  88.  
  89.           3) The center three characters of the line are not blank or
  90.              hyphens.
  91.  
  92.           Note: The easiest way to format a line that will be accepted
  93.              as a heading is to start with 5 hyphens, then the heading
  94.              text, then some other special character (like "=" or "@")
  95.              to at least position 40.
  96.  
  97.        If the line does not qualify as an ingredient line, heading
  98.        line, or end of recipe line, as specified above, data in
  99.        positions 3-77 (or 1-75 if positions 1-2 are non-blank) will be
  100.        imported as a direction line.
  101.  
  102.        Note: One of the most common errors in formatting a recipe for
  103.        import is an ingredient line that has been improperly
  104.        formatted.  When this is encountered, the line is usually
  105.        interpreted as a direction line by the program.  To help guard
  106.        against this, the program will display an error message if it
  107.        finds a line that appears to be a direction line FOLLOWED by a
  108.        valid ingredient line.
  109.  
  110.        Note: A less common error is starting a direction line in
  111.        positions 12 or 13.  Such a line "looks" like an ingredient
  112.        line with no quantity or unit of measure, so an error message
  113.        is given if it is found in the Direction section.  Make sure
  114.        that direction lines start before column 12 or after column 13.
  115.  
  116.  
  117.  
  118.      Files can contain multiple recipes, so long as each begins with a
  119.      "header line" and ends with a "trailer" line.  Any text in the
  120.      file that is not between the header and trailer lines is ignored.
  121.  
  122.      NOTE:  THIS SPECIFICATION IS ONLY VALID FOR MEAL-MASTER VERSION
  123.             7.0 AND HIGHER, AND WILL NOT WORK PROPERLY WITH EARLIER
  124.             VERSIONS.  PLEASE OBTAIN VERSION 7.0 OR GREATER FOR PROPER
  125.             RESULTS!